home *** CD-ROM | disk | FTP | other *** search
/ IRIX Base Documentation 1998 November / IRIX 6.5.2 Base Documentation November 1998.img / usr / share / catman / u_man / cat1 / inperson.z / inperson
Text File  |  1998-10-30  |  25KB  |  529 lines
  1.  
  2.  
  3.  
  4. IIIInnnnPPPPeeeerrrrssssoooonnnn((((1111))))                                                        IIIInnnnPPPPeeeerrrrssssoooonnnn((((1111))))
  5.  
  6.  
  7.  
  8. NNNNAAAAMMMMEEEE
  9.      inperson - InPerson desktop conferencing for SGI workstations
  10.  
  11. DDDDEEEESSSSCCCCRRRRIIIIPPPPTTTTIIIIOOOONNNN
  12.      InPersonTM is a multimedia desktop conferencing tool for SGI workstations
  13.      such as the Indy, Indigo and Indigo2.  Each conference includes audio and
  14.      either video or a static image of the participant. Use of shared
  15.      whiteboard and shared shelf is optional on a per-conference basis.  Other
  16.      SGI systems that lack audio and/or video hardware can still use the
  17.      shared whiteboard.
  18.  
  19.      You can place a conference on hold, or can look and listen to a
  20.      conference without transmitting any audio and video. This allows you to
  21.      simultaneously work on urgent projects while monitoring the progress of a
  22.      conference.  This also allows you to hold an impromptu private
  23.      conversation in your office without disturbing the ongoing conference.
  24.  
  25.      Each conference can have 2 to 8 participants when using Indy R4400SC
  26.      models.  Due to the use of multicasting, total network bandwidth usage
  27.      scales linearly with the number of participants.
  28.  
  29.      The InPerson product consists of several programs: the phone, the
  30.      conference view, and the whiteboard.  The _i_n_p_e_r_s_o_n program is the phone
  31.      tool that you see on your desktop.  The view program opens the main
  32.      conference window.  It manages all audio and video actions, the shared
  33.      shelf, and the whiteboard.  The whiteboard program is opened by the view
  34.      when a user asks to open it. These two programs are started on behalf of
  35.      the user by _i_n_p_e_r_s_o_n.
  36.  
  37. UUUUSSSSAAAAGGGGEEEE
  38.      Please see the on-line InPerson User's Guide and the InPerson Setup and
  39.      Administration Guide for detailed instructions on the use of this
  40.      product. What follows is a brief summary.
  41.  
  42.    PPPPllllaaaacccciiiinnnngggg aaaannnndddd RRRReeeecccceeeeiiiivvvviiiinnnngggg CCCCaaaallllllllssss
  43.      To place or receive calls, you must run the _i_n_p_e_r_s_o_n program.  To run
  44.      _i_n_p_e_r_s_o_n, double-click its icon from the Icon Catalog's Collaboration
  45.      page or type in a shell:
  46.  
  47.                % inperson
  48.  
  49.  
  50.      When you run _i_n_p_e_r_s_o_n, the image of an old-fashioned telephone appears on
  51.      your desktop. The phone rings and flashes when someone is calling you. To
  52.      answer a call, place the cursor over the phone; then click the left mouse
  53.      button. To make a call, drag group or user icons over the phone image and
  54.      release the mouse button.
  55.  
  56.    PPPPaaaarrrrttttiiiicccciiiippppaaaattttiiiinnnngggg iiiinnnn aaaa CCCCoooonnnnffffeeeerrrreeeennnncccceeee
  57.      The conferencing window appears when you participate in a call. By
  58.      default, it displays video of each person participating in the
  59.      conference. Participant on systems that do not supports video are
  60.  
  61.  
  62.  
  63.                                                                         PPPPaaaaggggeeee 1111
  64.  
  65.  
  66.  
  67.  
  68.  
  69.  
  70. IIIInnnnPPPPeeeerrrrssssoooonnnn((((1111))))                                                        IIIInnnnPPPPeeeerrrrssssoooonnnn((((1111))))
  71.  
  72.  
  73.  
  74.      represented by a static image. See "Faces Database" section below to
  75.      learn how to select a static image.
  76.  
  77.      The conferencing window can expand to show two other regions - the
  78.      whiteboard and the shelf. To open the whiteboard, choose "Open
  79.      whiteboard" from the Call menu. To open the shelf, choose "Open shelf"
  80.      from the Call menu.
  81.  
  82.    AAAAbbbboooouuuutttt tttthhhheeee WWWWhhhhiiiitttteeeebbbbooooaaaarrrrdddd
  83.      The whiteboard is similar to the whiteboard or chalkboard you might find
  84.      in a conference room. Each person in the conference has a unique marker
  85.      that she or he can use to sketch or write notes on the board. People can
  86.      also take screen and video snapshots and place them on the board.  You
  87.      can bring in 3D Inventor models, text and RGB image files from the Import
  88.      menu, too.  You can save your work for a later conference, or print it to
  89.      get a hard copy.
  90.  
  91.      When placing images and 3D, you can stretch their size by clicking and
  92.      dragging the mouse.  Then, subsequently move any object by clicking on it
  93.      and dragging.  You can also `lasso' objects with the selection tool.
  94.      When a 3D object is selected, scale and rotation handles show up.  The
  95.      corner squares allow you to uniformly scale the object, while the round
  96.      rotation knobs allow you to rotate it.  Use the shift key to get fixed
  97.      rotation about an axis.
  98.  
  99.      The toolbar along the left edge of the whiteboard page has tools for
  100.      drawing, typing, taking snapshots, selecting colors, text styles, and
  101.      line styles, and adding new pages.  If you wave your cursor over an
  102.      object on the whiteboard, the text under the person's video image will
  103.      highlight, indicating who drew it.
  104.  
  105.  
  106.    AAAAbbbboooouuuutttt tttthhhheeee SSSShhhheeeellllffff
  107.      The shelf is similar to the shelves that are used within the IRIX
  108.      Interactive Desktop(TM) user environment.  Files placed on the shelf are
  109.      instantly accessible to all persons in the conference.  You can bring the
  110.      file to the local file system by clicking on and dragging the icon from
  111.      the shelf to an _f_m (_1) view of one of the local directories.  Dragging
  112.      the icon to the desktop puts only a link to the file on the desktop. The
  113.      actual file may not be accessible later so if you want to save the file,
  114.      drag the file icon to a local directory.
  115.  
  116.      You can double-click over an icon on the shelf to open it, as with any
  117.      IRIX Interactive Desktop icon.  If the icon is a folder, a directory view
  118.      is launched for that folder.  For any other category of icon you may be
  119.      notified that InPerson does not know how to run that application shared
  120.      between the conference participants and asked if you want to run it
  121.      standalone.
  122.  
  123.      When InPerson is unable to access a file via NFS, it makes a local
  124.      temporary copy of the file in a _s_h_a_d_o_w _d_i_r_e_c_t_o_r_y so as to preserve all of
  125.      the file operation semantics of IRIX Interactive Desktop icons.  All
  126.  
  127.  
  128.  
  129.                                                                         PPPPaaaaggggeeee 2222
  130.  
  131.  
  132.  
  133.  
  134.  
  135.  
  136. IIIInnnnPPPPeeeerrrrssssoooonnnn((((1111))))                                                        IIIInnnnPPPPeeeerrrrssssoooonnnn((((1111))))
  137.  
  138.  
  139.  
  140.      temporary copies and the shadow directory are removed at the end of a
  141.      call.  The location of the shadow directory is controlled by an X
  142.      resource (see below) and by the INBOX_PATH environment variable.
  143.  
  144.      If the environment variable INBOX_PATH is set to a directory path,
  145.      InPerson uses that directory as the shadow directory but won't delete
  146.      files from it.  When a file is dropped on the shelf by another person in
  147.      the conference, InPerson will check to see if that file has been
  148.      transfered in advance by looking for a file of the same name in the INBOX
  149.      directory.  If so, then the file is referenced on the shared shelf
  150.      immediately.  Files copied into the INBOX directory (before or during a
  151.      conference) will not be removed.  This is the responsibility of the user.
  152.  
  153.      The shelf will only allow you to drop files which are local to your own
  154.      system or are accessible to you via NFS.
  155.  
  156. CCCCUUUUSSSSTTTTOOOOMMMMIIIIZZZZAAAATTTTIIIIOOOONNNN
  157.      There are two control panels that let you set preferences to customize
  158.      the behavior of the phone and of a running conference. You can also save
  159.      the preferences as the default for future calls into the _I_n_P_e_r_s_o_n file in
  160.      the the $HOME/.desktop-`hostname` directory.
  161.  
  162.      To access the phone's control panels, place the cursor over the phone,
  163.      and then press the right mouse button to bring the menu. Choose "Ring
  164.      control panel..." from the menu to change the incoming and outgoing
  165.      ringing sounds.  Chose "Call preferences panel..." to change video and
  166.      network parameters and is described below.  On each panel, the "Save"
  167.      button saves the preferences into the _I_n_P_e_r_s_o_n file. The "OK" button
  168.      applies the preferences to future incoming and outgoing calls but not the
  169.      current call.
  170.  
  171.      The InPerson Call window also provides a control panel under the Tools
  172.      menu that you can use to change the characteristics of the call in
  173.      progress.
  174.  
  175.      The Call control panel, which is also accessible from the phone, has two
  176.      sections.  The Video Controls lets you change the size of the video
  177.      images that are shown in the participant display area.  The Vanity View
  178.      buttons controls whether images from your camera are shown in the
  179.      participant display area and whether the view is shown as other see it or
  180.      mirrored.  The Call Controls section controls outgoing video, compression
  181.      and network parameters.  if the Outgoing Video button is set to "Live",
  182.      InPerson will will capture and transmit video if video hardware is
  183.      available. If set to "Static Image", InPerson will always use a static
  184.      image in place of video.  The most common reason to change this setting
  185.      to "Static Image" is to decrease the network bandwidth required for a
  186.      call.
  187.  
  188.      InPerson automatically choses the appropriate video and audio compression
  189.      schemes based on network bandwidth and the user's performance preference.
  190.      The control panel lets you select the following information:
  191.  
  192.  
  193.  
  194.  
  195.                                                                         PPPPaaaaggggeeee 3333
  196.  
  197.  
  198.  
  199.  
  200.  
  201.  
  202. IIIInnnnPPPPeeeerrrrssssoooonnnn((((1111))))                                                        IIIInnnnPPPPeeeerrrrssssoooonnnn((((1111))))
  203.  
  204.  
  205.  
  206.      +o  performance preference: In the presence of network congestion,
  207.         InPerson can prefer video quality (and degrade frame rate) or prefer
  208.         frame rate (and degrade video quality).
  209.  
  210.      +o  network bandwidth type:  ISDN basic rate, T1/E1, LAN, (e.g.,
  211.         Ethernet), high-speed LANs (e.g., FDDI/CDDI, ATM).
  212.  
  213.      +o  finer control bandwidth slider: it lets you select the bandwidth
  214.         target within the bandwidth range specified by the network type.
  215.  
  216.      For example, if you select the LAN network type, the bandwidth range is
  217.      0-5000 kbps. You can move the slider to use more or less bandwidth.
  218.      InPerson then choses a video compression scheme that meets that target.
  219.  
  220.      For a given bandwidth, two compression schemes might be possible:  one
  221.      has a better image quality but a slower update(frame) rate, while the
  222.      other has a faster frame rate but lesser image quality.  The Performance
  223.      Preferences button lets you choose which characteristic is more
  224.      important.
  225.  
  226.    RRRReeeessssoooouuuurrrrcccceeeessss
  227.      There are some additional preferences that control the behavior of
  228.      InPerson that are not on the control panels. Advanced users can change
  229.      these resources by editing the InPerson user configuration file.
  230.  
  231.      The default X11 resources file /usr/lib/X11/app-defaults/InPerson
  232.      contains a few resources that can be customized at the beginning of the
  233.      file.  You can edit this file as root to make changes for all users on
  234.      the system. If you want your private customizations, copy the file to
  235.      $HOME/.desktop-`hostname`/InPerson, then following the instructions at
  236.      the beginning of the file.
  237.  
  238.      InPerson*facesPath (Faces database path)
  239.           This resource controls which directories InPerson searches when
  240.           looking for static images of user's faces. InPerson always checks
  241.           $HOME/.icons/login.icon first, and then for each directory specified
  242.           in the faces path, looks in <dir>/$USERNAME. Default value is
  243.           "/usr/local/lib/faces:/usr/lib/faces". See the section below, "Faces
  244.           Database", on adding a face file.
  245.  
  246.      InPerson*defaultFace (Default face image)
  247.           This resource controls what face image is displayed if the user does
  248.           not have an entry in the faces database. Default is "inperson".
  249.  
  250.      InPerson*participantBox.initialPlacement (Participant Layout)
  251.           This resource controls whether the images of participants in the
  252.           conference are placed horizontally or vertically in the InPerson
  253.           Call window.  Possible values are "VERTICAL" and "HORIZONTAL".
  254.           Default is "VERTICAL".
  255.  
  256.  
  257.  
  258.  
  259.  
  260.  
  261.                                                                         PPPPaaaaggggeeee 4444
  262.  
  263.  
  264.  
  265.  
  266.  
  267.  
  268. IIIInnnnPPPPeeeerrrrssssoooonnnn((((1111))))                                                        IIIInnnnPPPPeeeerrrrssssoooonnnn((((1111))))
  269.  
  270.  
  271.  
  272.      InPerson*shelf.shadowDir (Location of directory for shadowing the shelf)
  273.           This resource controls what directory InPerson will use when it
  274.           needs to make copies of files that are to appear on the shelf.  The
  275.           default value is "$HOME/.InPerson.shelf".  InPerson appends "." and
  276.           six more characters to this name to make a unique name for each
  277.           call.  This resource is overridden by the INBOX_PATH environment
  278.           variable (see above).
  279.  
  280.      InPerson*shelf.xferTimeMsgThreshold (Threshold for transfer time notice)
  281.           When you drop files on the shelf, it calculates the time to transfer
  282.           the files to the other participants based on the current audio and
  283.           video bandwidths. If the transfer time exceeds this threshold, the
  284.           shelf will display a dialog box with the time and a choice to
  285.           continue or cancel the transfer.  The default value is 60 seconds.
  286.           Set the resource to 0 to disable the calculation and the dialog box.
  287.  
  288.      InPerson*videoDevice (Video device name)
  289.           For Indy systems that have the built-in VINO video hardware and the
  290.           optional IndyVideo board, this resource lets select which one to
  291.           use.  The default is "vino".
  292.  
  293.      InPerson*keyFrameInterval (Video key frame interval)
  294.           This resource controls how often a complete video frame is sent.
  295.           Normally, HDCC compression just sends the portion of the video frame
  296.           that changed.  Periodically, HDCC sends out the complete video
  297.           frame, regardless of whether or not it is changed, If a network
  298.           packet containing compressed video is lost, that portion of the
  299.           image will not be updated until it changes again, or until the next
  300.           key frame is sent.  Default value is 15 seconds; a useful range is
  301.           10-600 seconds with 0 to disable it.  Most common reason to decrease
  302.           this resource from the default value is to improve image quality on
  303.           a network with a high packet loss rate.  Most common reason to
  304.           increase this resource from the default value is to decrease the
  305.           network bandwidth required for video.
  306.  
  307.      InPerson*videoRate (Video frame rate)
  308.           Controls the maximum frame rate for capturing video when using LANs
  309.           or slower networks. The default is 15 frames per second.
  310.  
  311.      InPerson*videoRateHSLAN (Video frame rate for high-speed LAN)
  312.           InPerson can send uncompressed video at 30 frames per second _o_n_l_y if
  313.           your machine is attached to a high-speed LAN such as FDDI or ATM.
  314.           You must configure the networkMTU resource as described above and
  315.           select the "Hi-speed LAN and "Optimize Frame Rate" buttons in the
  316.           Call preferences Panel to enable this feature.  The default value is
  317.           30 frames per second.
  318.  
  319.      InPerson*audioInputSource (Audio source)
  320.           This resource sets the audio input source to the microphone ("mic"),
  321.           line-in ("line") or the current _a_p_a_n_e_l(1) setting ("default").  If
  322.           not specified, the input source is set to the microphone.  The call
  323.           saves the current _a_p_a_n_e_l(1) value in your resource file when the
  324.  
  325.  
  326.  
  327.                                                                         PPPPaaaaggggeeee 5555
  328.  
  329.  
  330.  
  331.  
  332.  
  333.  
  334. IIIInnnnPPPPeeeerrrrssssoooonnnn((((1111))))                                                        IIIInnnnPPPPeeeerrrrssssoooonnnn((((1111))))
  335.  
  336.  
  337.  
  338.           call exits.
  339.  
  340.      InPerson*audioLeftAtten (Audio input levels)
  341.           and InPerson*audioRightAtten.  These resources set the initial audio
  342.           input level to the specified values. The range is 255 (soft) to 0
  343.           (loud).  The call saves the current _a_p_a_n_e_l(1) values in your
  344.           resource file when the call exits.
  345.  
  346.      InPerson*audioAutoRateConversion (Audio sample rate conversion)
  347.           This resource enables or disables automatic sample rate conversion
  348.           when playing audio from the conference.  For example, if you CDman
  349.           running, and this resource is True, the call will produce audio at
  350.           the same sampling rate used by CDman.  If the resource is False, the
  351.           call will change the audio output sample rate to match the current
  352.           audio compression scheme.
  353.  
  354.      InPerson*audioInputGain (Audio input gain)
  355.           This resource boosts the level of the audio from the microphone.
  356.           The most common reason to change this because other conference
  357.           participants have trouble hearing you even with your audio input
  358.           level set to its maximum value. It is a integer value; default is 2.
  359.           Valid range is 1 to 8.
  360.  
  361.      InPerson*audioSuppressSilence (Audio silence suppression)
  362.           By default, InPerson detects when you're not talking to avoid
  363.           sending unnecessary audio packets, thus saving network bandwidth.
  364.           The silence detection algorithm may not work well in noisy
  365.           environments and depends on the audio input level set by _a_p_a_n_e_l(1).
  366.           Set to false to disable.
  367.  
  368.      InPerson*fontNumber (Whiteboard default font)
  369.           The whiteboard has four font choices, selectable via a menu.  This
  370.           resource specifies the default choice.  Range: 0 to 3, with 0 as the
  371.           default.
  372.  
  373.      InPerson*drawingLineWidth (Whiteboard default line width)
  374.           Specifies the default line width for the whiteboard.  Range: 0 to 3,
  375.           with 2 as the default.
  376.  
  377.      InPerson*showDrawer (Display who-drew-what on the whiteboard)
  378.           Enables whether or not the whiteboard displays the name of the
  379.           person who drew the object pointed to by the mouse.  Values: "on"
  380.           (default) or "off".
  381.  
  382.      InPerson*imageDirectory (Default location for images)
  383.           This resource specifies the initial directory shown by the file
  384.           browser when importing an image.  Default is /usr/share/data/images.
  385.  
  386.      InPerson*textFileDirectory (Default location for text files)
  387.           This resource specifies the initial directory shown by the file
  388.           browser when importing a text file.  Default is your home directory.
  389.  
  390.  
  391.  
  392.  
  393.                                                                         PPPPaaaaggggeeee 6666
  394.  
  395.  
  396.  
  397.  
  398.  
  399.  
  400. IIIInnnnPPPPeeeerrrrssssoooonnnn((((1111))))                                                        IIIInnnnPPPPeeeerrrrssssoooonnnn((((1111))))
  401.  
  402.  
  403.  
  404.      InPerson*modelFileDirectory (Default location for 3D models)
  405.           This resource specifies the initial directory shown by the file
  406.           browser when importing a model.  Default is /usr/share/data/models.
  407.  
  408.      InPerson*networkMTU (Conference network packet size)
  409.           Lets you specify the underlying network packet size.  If you have a
  410.           network that is composed entirely of FDDI rings, set this value to
  411.           the FDDI MTU of 4352 (see the output of /_u_s_r/_e_t_c/_n_e_t_s_t_a_t  -_i for
  412.           appropriate MTU values).  See the comments in the app-defaults file
  413.           for more details.
  414.  
  415.      InPerson*multicastTTL (Conference network range)
  416.           This resource affects how how widely distributed the multicast
  417.           packets will be through the network. It is specified in hops;
  418.           maximum number of IP multicast routers between any two participants
  419.           in a conference.  Default value is 10. Range is 1 (meaning local net
  420.           only) to 63.
  421.  
  422.      InPerson*networkPortMin/Max (Conference network port range)
  423.           If you want to use InPerson through a network packet
  424.           filter/firewall, these two resources let you specify the range of
  425.           ports used for audio and video UDP packets and for whiteboard TCP
  426.           packets.  InPerson RPC packets use the TCP port that is defined in
  427.           the file /_e_t_c/_s_e_r_v_i_c_e_s for the service named "sgi_iphone".  If that
  428.           service is not defined, InPerson RPC packets use TCP port 32769.
  429.           Make sure the port is not in the range used by networkPortMin and
  430.           networkPortMax.
  431.  
  432.    FFFFaaaacccceeeessss DDDDaaaattttaaaabbbbaaaasssseeee
  433.      _i_n_p_e_r_s_o_n displays static face images of users in several circumstances.
  434.      When an incoming call is ringing, the a face image is displayed
  435.      alternately with the phone icon to indicate who is calling. During a
  436.      call, a static face image is displayed for users without video hardware.
  437.      This static face image is in the same format and location(s) as used by
  438.      _c_l_o_g_i_n(1).  If _i_n_p_e_r_s_o_n cannot find a face image for a specific user, it
  439.      uses the face image for "inperson", if it exists.
  440.  
  441.      To add yourself to the faces database, run _c_a_p_t_u_r_e(1) on a workstation
  442.      equipped with video. Pose in front of the camera, and use the image
  443.      snapshot feature to create a quarter-sized static image.  Then copy that
  444.      file to one of the faces locations as specified by _c_l_o_g_i_n(1).
  445.  
  446. NNNNOOOOTTTTEEEESSSS
  447.      The audio input sampling rate is automatically set to the sampling rate
  448.      used by the audio compression scheme. The default scheme uses a 16kHz
  449.      rate. The behavior for the audio output sampling rate depends on the
  450.      audioAutoRateConversion resource described above.
  451.  
  452.      _i_n_p_e_r_s_o_n's on-line help requires the InPerson User's Guide and the Setup
  453.      & Administration Guide to be installed.
  454.  
  455.  
  456.  
  457.  
  458.  
  459.                                                                         PPPPaaaaggggeeee 7777
  460.  
  461.  
  462.  
  463.  
  464.  
  465.  
  466. IIIInnnnPPPPeeeerrrrssssoooonnnn((((1111))))                                                        IIIInnnnPPPPeeeerrrrssssoooonnnn((((1111))))
  467.  
  468.  
  469.  
  470. FFFFIIIILLLLEEEESSSS
  471.      /usr/sbin/inperson
  472.      /usr/lib/X11/app-defaults/InPerson
  473.      $HOME/.desktop-`hostname`/InPerson
  474.      $HOME/.InPerson.aliases
  475.  
  476. BBBBUUUUGGGGSSSS
  477.      Please see the InPerson release notes for known bugs and workarounds.
  478.  
  479.      If the original sender of a file on the shelf leaves the conference and
  480.      another participant sends that file on to a newly joined participant, the
  481.      newly joined participant will only be able to access the file if it is
  482.      available via NFS. The workaround is for the user wishing to send the
  483.      file, to drag the file to a local directory view then drop the new local
  484.      copy on the shelf.
  485.  
  486.  
  487.  
  488.  
  489.  
  490.  
  491.  
  492.  
  493.  
  494.  
  495.  
  496.  
  497.  
  498.  
  499.  
  500.  
  501.  
  502.  
  503.  
  504.  
  505.  
  506.  
  507.  
  508.  
  509.  
  510.  
  511.  
  512.  
  513.  
  514.  
  515.  
  516.  
  517.  
  518.  
  519.  
  520.  
  521.  
  522.  
  523.  
  524.  
  525.                                                                         PPPPaaaaggggeeee 8888
  526.  
  527.  
  528.  
  529.